home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software of the Month Cl…Business) - New Member 21
/
Software of the Month Club XXI - New Member Business.ISO
/
mac
/
SOMCNMXXIBUS
/
DOS
/
BIZ
/
SALESREG
/
EC.DOC
< prev
next >
Wrap
Text File
|
1995-10-31
|
27KB
|
1,256 lines
EZ Com. tm
USER'S GUIDE
Copyright (c) 1990-1995 Louis M. Robert
All Rights Reserved
This publication is protected by federal
copyright law. No part of this
publication may be copied, translated
into any form or by any means,
electronic, magnetic, mechanical,
manual, or otherwise, or stored in a
retrieval system without the written
permission of Louis M. Robert,
1948 Hwy. 114 - Hessmer, La. 71341.
DISCLAIMER
THIS SOFTWARE AND MANUAL ARE SOLD "AS IS"
AND WITHOUT WARRANTIES AS TO PERFORMANCE
OR MERCHANTABILITY. THE SELLER'S SALES-
PERSON MAY HAVE MADE STATEMENTS ABOUT
THIS SOFTWARE.ANY SUCH STATEMENTS DO NOT
CONSTITUTE WARRANTIES AND SHALL NOT BE
RELIED ON BY THE BUYER IN DECIDING
WHETHER TO PURCHASE THIS PROGRAM.
THIS PROGRAM IS SOLD WITHOUT ANY EXPRESS
OR IMPLIED WARRANTIES WHATSOEVER.BECAUSE
OF THE DIVERSITY OF CONDITIONS AND
HARDWARE UNDER WHICH THIS PROGRAM MAY BE
USED, NO WARRANTY OF FITNESS FOR A
PARTICULAR PURPOSE IS OFFERED.THE USER
IS ADVISED TO TEST THE PROGRAM THOROUGHLY
BEFORE RELYING ON IT.THE USER MUST ASSUME
THE ENTIRE RISK OF USING THE PROGRAM.ANY
LIABILITY OF SELLER OR MANUFACTURER WILL
BE LIMITED EXCLUSIVELY TO PRODUCT REPLA-
CEMENT OR REFUND OF THE PURCHASE PRICE.
For technical assistance or to make
suggestions, contact:
Louis M. Robert
1948 Hwy. 114
Hessmer, La. 71341
(318) 563-4428
TABLE OF CONTENTS PAGE
1-1 INTRODUCTION.............................................. 1
1-2 THE KEYBOARD.............................................. 2
1-3 INSTALLATION.............................................. 3
2-1 EZ Com. OPERATION......................................... 4
2-2 EZ Com. COMMANDS.......................................... 5
2-3 SCRIPT COMMANDS........................................... 10
2-4 SCRIPT FILES.............................................. 15
1-1 INTRODUCTION
EZ Com. is a telecommunications software package, to be used
with an IBM PC or compatible microcomputer.
EZ Com. can be used with Sales Register III to send & receive
SRIII Data files from one location to another. This would be es-
pecially useful to print reports from multiple stores, at a cent-
ral location. EZ Com. can be used for most modem communications.
EZ Com. features include:
1. A command structure, allowing use of Alt+keys, redefinable
function keys, and script files to control program operation.
2. User selectable terminal types, such as DUMB, BBS ANSI,
VT100, and VT52.
3. A phonebook database, up to 499 phone numbers can be stored,
for dialing remote computers.
4. An assortment of standard protocols, such as, XMODEM, MODEM7,
YSINGLE, and YMODEM can be used to transfer files from one
system to another, in single-file or batch modes.
5. Keeps a log file of EZ Com. activity. The name of the log file
will be today's date plus .LOG, (YYMMDD.LOG) i.e. 950701.LOG.
Each day will have a different Log File. You may view the Log
file by pressing the Alt+V keys, then type the Log File name
you want to view. To print the screen contents press the
Shift+PrintScreen keys.
1
1-2 THE KEYBOARD
Alt+F10 Displays the commands menu.
Alt+C Clears the screen.
Alt+D Calls up the Dialing Directory for auto-dialing and to
enter/edit phone numbers in the phone data base file.
Alt+E Toggles echo on/echo off.
USE IF YOUR KEYBOARD INPUT IS BLANK OR DOUBLE.
Alt+F Displays the file directory on the logged drive.
Alt+G Writes the contents of the screen to a file, named
SCRNDUMP.TXT, on the Logged drive.
Alt+H Hangs up (disconnects the phone line from the modem).
Alt+P Permits changing the communications Parameters.
Alt+S Permits changing terminal emulation.
Alt+V Allows you to view a file which has been saved to disk.
Alt+X Exits the program and returns to DOS.
Alt+Z Permits changing monitor colors.
Alt+F4 Permits shelling to DOS
Alt+F5 Permits execution of a script file
PgDn Permits you to receive files from a remote computer and
save them to disk.
PgUp Permits you to transmit files to a remote computer.
Shift+PrintScreen Prints screen contents to printer.
2
1-3 INSTALLATION
1. EZ Com. will be installed when you install Sales Register III.
2. Reset communications parameters, if the EZ Comm. default
settings or not correct. The parameters may be changed with
an INIT.SCP file, or by typing Alt+P from the commands menu.
The EZ Com. parameter defaults are:
Comm. port 1
Baud rate 1200
Parity N
Data bits 8
Stop bits 1
Phone type T
Terminal type Dumb
The Stop Bits will always be 1.
3. Two Script files are provided with EZ Com. to automate the send-
ing & receiving of SRIII data files. These script files are
SEND.SCP & RECEIVE.SCP.
If you need to modify these files or create an INIT.SCP file or
create any other Script file please refer to page 15.
4. In order for EZ Com. to properly hang up your modem, you
must set the modem to recognize the DTR and CARRIER signals.
That is, the DTR and CARRIER must not be "forced high". If you
find that EZ Com. will not hang up the phone, you will
probably need to change the settings on your modem. See your
modem manual for information on how to do this.
5. If your modem connects, but you can't transmit, you may have to
disable DTE/DCE flow control.
6. If you are using a high speed modem at 14,400 baud, you may be
able to use an EZ Com. baud rate of 57600, and obtain a higer
throughput.
3
2-1 EZ Com. OPERATION
To run EZ Com. from the C:\SRIII prompt, type EC <Enter>.
EZ Com. will load into computer memory, then check for an
INIT.SCP file. If an INIT.SCP file is found, it will be executed.
When you see the prompt "EZ Com. is ready...". EZ Com. is in op-
eration.
Press the Alt+F10 keys at the same time to display the commands
menu.
You may proceed to send the appropriate EZ Com. commands directly
from the keyboard.
Please refer to page 5, for instructions on using the dialing
directory.
Dial the phone number you wish and wait for your computer to make
a connection with the remote computer you dialed. When a
connection is made, you can proceed with keyboard instructions.
You can send information to the remote computer by typing on the
keyboard, and see information sent by the remote computer displayed
on your screen.
NOTE: IF YOU CAN'T SEE YOUR KEYBOARD INPUT, TYPE Alt+E TO TOGGLE
ECHO ON.
EZ Com. is capable of doing many more things, such as receiving
and sending disk files, dialing phone numbers, and storing funct-
ion key macro commands for future use. All the program features
are described in the documentation.
Please read the documentation. This will greatly increase your
proficiency in using the program.
4
2-2 EZ Com. COMMANDS
Alt+C Clear Screen
Typing Alt+C will clear the screen at any time. This command does
not send any character or signal to the remote computer.
Alt+D Dialing Directory
The Alt+D command calls up the Dialing Directory, which is one of
EZ Com.'s most useful features. The Directory can list up to
499 names and phone numbers, plus communications parameters and
script for each entry.
The following instructions will first show you how to place names
and phone numbers into the Directory and then describe how to use
the Directory as part of your standard communications routines.
When the Directory is called up for the first time, all entries
will be blank. To add names and phone numbers to the Directory or
to edit the Directory later on, enter E . The edit mode window
will be displayed on the screen. Press F1 to display the Add an
Entry window. You may use the DOS or WORD STAR editing keys to
fill in the fields. To edit an entry press F2, then enter the
number to edit.To add/edit entries, type in the name, followed by
<Enter>. Type in the phone number followed by <Enter>. Up to 14
characters may be specified for the phone number. If the default
baud rate, parity and word length are acceptable, press <Enter>
for each field. If there is a script file to be executed after
this number is dialed and a connection made, type in the name of
the script file, in the script field. After all the field entries
are correct, press Esc. You will then be asked whether to save
this entry to disk file, enter Y. The directory will now show the
new information you input. The name, phone number, communications
specs., and script will be permanently stored in a separate file,
named DIALER.DAT, on your default disk drive. Repeat the above
steps for each name and phone number you want to add to the
Directory.
AUTO-DIALING
The Dialing Directory will automatically dial a Directory entry.
Press the up or down arrows to highlight the entry to dial and
press <Enter>, or type M <Enter> and type the record number of
the entry to dial.
5
You can also use auto-dialing to call phone numbers not stored in
the Dialing Directory. From the main Dialing Directory prompt,type
M <Enter>. A prompt will then ask for the phone number to be dialed.
Type the phone number and press <Enter>, and the number will be
dialed automatically.
You should note that when you place a call through the Dialing
Directory, the Communications Parameters will remain in effect,
even after the call is completed.
MANUAL DIALING
At the promt, EZ Com. is Ready..., type ATDT phonenumber.
ie. (ATDT 3185634428)
Alt+E Toggle Local Echo On/Off
If the remote computer sends back to your screen the characters
you type at your keyboard, it is operating at full duplex
communications. If the remote computer does not send back the
characters you type, it is operating at half duplex. You may adjust
for either one of these situations with the Echo option, which is
toggled on and off by pressing Alt+E.
If you can't see your own keyboard input on the screen once
communications are in progress, turn Local Echo on by typing Alt+E
If your keyboard input appears as double characters, turn Local
Echo off by typing Alt+E.
Alt+F File Directory
This command permits you to view the file directory, on the
default disk drive. You cannot do this if you are connected to a
remote computer.
Alt+G Screen Dump
This command allows you to dump the contents of the screen to a
disk file at any time by pressing Alt+G.
Each time you press Alt+G, the screen contents will be appended
to the SCRNDUMP.TXT file, on the default drive.
Alt+H Hang Up
Hangs up the telephone, disconnecting the call.
Alt+P Set Com. Parameters
When you press Alt+P, a window will display the communications
parameters at the top and the choices below. To change the baud
rate enter A-J. To change the parity and word length enter K or
J. To change the Com. Port enter M or N. To change the phone type
enter P or T. When you or finished, press Esc or Q.
6
Alt+S Set Terminal Type
When you press Alt+S, a window will display the terminal
emulations supported by EZ Com.. Enter 1-5 to select the term-
inal of your choice.
Alt+V View a File
EZ Com. permits you to view any file which is on your default
disk drive, while your computer is not connected to a remote
computer. This feature makes it possible for you to refer to files
on disk. To View a file, press Alt+V. The program will ask for a
file name. Once Viewing is in progress, 23 lines of text will be
displayed on the screen at a time. To see more of the file,
press any key. To cancel the Viewing routine, press Ctrl-Break.
You can print selective portions of the file by using the
Printscreen function (Shift+PrtSc).
The DOS program, MORE.COM, must be in the default disk drive Dir..
Alt+X Exit
When you press Alt+X, a window will display the prompt, do you
want to exit EZ Com.(y/n)?. If you want to exit enter Y, otherwise
enter N.
Alt+Z Set Colors
This command will allow you to change the monitor colors.
Alt+F4 Shell to DOS
This command will allow you to shell to DOS, run another program,
then return to EZ Com., by typing EXIT. You cannot do this while
connected to a remote computer.
Alt+F5 Execute Script File
When you press Alt+F5, a window will display a prompt for you to
enter the scrpt file name. Once you enter the file name that
script will be executed.
7
PgDn Receive a File
This command permits you to receive and save files transmitted to
you from a remote computer.
To start the Receiving routine, press PgDn.
The program will ask for:
1 XMODEM
2 MODEM7
3 XMODEM-1K/YMODEM SINGLE
4 YMODEM
If you select 1 or 3, the program will ask for a filename under
which to receive the file.
MODEM7 and YMODEM are batch file transfer protocols that can
receive multiple files at one time and will use the filename(s)
specified by the sender. If the filename is not given an extension,
the default extension LZH will be used. You may over-ride this by
putting a period at the end of the filename.
To guard against accidentally erasing existing files, if a filename
is specified that already exists on the disk, you will be
prompted that the file already exists, delete Y/N?.
A window will display the status of the file being received.
The receive routine will terminate automatically at the end
of the file.
To terminate receipt of a file, press Esc.
PgUp Send a File
This command permits you to transmit disk files to a remote
computer.
To start the Transmit routine, press PgUp.
The program will ask for:
1 XMODEM
2 MODEM7
3 XMODEM-1K/YMODEM SINGLE
4 YMODEM
The program will ask for the filename to be transmitted. If you
select 2 or 4 you may enter wildcards, such as, (*.LZH). MODEM7
and YMODEM are batch file transfer protocols that can send
multiple files at one time. If the filename is not given an
extension, the default extension LZH will be used. You may over-
ride this by putting a period at the end of the filename.
A window will display the status of the file being transmitted.
The transmission routine will terminate automatically at the end
of the file.
To terminate transmission of a file, press Esc.
8
Shift+PrtSc Print Screen
You may print the screen contents to the printer at any time, by
pressing the Shift Key in combination with the PrtSc key.
(This is a DOS function).
9
2-3 SCRIPT COMMANDS
The script language is composed of commands, each of which may
contain one or more parameters with a space between them.
A list of valid commands are:
COMMAND PARAMETER
------- ---------
BAUD baudrate
CLS
COLOR foreground background
DIAL number scriptfile
ECHO on/off
EMULATE terminal
END
EXIT
FUNCTION functionkey scriptcommand
HANGUP
INPUT message
OUTPUT message
PARITY parity wordlength
PHONETYPE pulse/tone
PORT commport
PRINT message
RECEIVE protocol filename
SEND protocol filename
SHELL filename
TIMEOUT delay scriptfile
RUN scriptfile
WAIT comm/delay
BAUD baudrate
Sets the speed of the comm port. Valid choices for the baudrate
parameter are: 300, 1200, 2400, 4800, 9600, 14400, 19200, 38400,
and 57600.
BAUD 1200
CLS
Clears the monitor screen.
COLOR foreground background
The color command sets the foreground and background monitor
colors. The foreground colors are 0-15, the background colors are
0-7:
COLOR 7 0
10
DIAL number scriptfile
Dials a given phone number. The scriptfile parameter is optional
and specifies a script file to execute, if the dial is successful
in connecting to the remote computer.
DIAL 3185634428 EFTBANK
ECHO on/off
Turns local echo ON or OFF. The parameter must be either ON or
OFF.
ECHO ON
EMULATE terminal
Specifies one of the following terminals to emulate:
DUMB standard dumb terminal
NOANSI removes and ignores ANSI codes
BBSANSI the ANSI.SYS variant of ANSI
VT52 VT52
VT100 VT100
To emulate the ANSI BBS terminal:
EMULATE BBSANSI
END
Exits the current script file, stops script processing and
Exits the EZ Com. program:
END
EXIT
Exits the current script file, stops script processing and
returns to EZ Com.:
EXIT
11
FUNCTION functionkey scriptcommand
The FUNCTION command defines a script macro for a given function
key. The functionkey parameter is any of F1 to F10, corresponding
to the appropriate function key. You may prefix this with an S
for shifted function keys, a C for control function keys, or an A
for Alt function keys. Note that EZ Com. uses several Alt function
keys for commands, you will not be able to redefine these. The scr-
ipt command parameter may be any script command.
FUNCTION F1 DIAL 3185634428 EFT.SCP
HANGUP
Hangs up the telephone, disconnecting the remote computer:
HANGUP
INPUT message
Waits for the specified message to be received from the comm
port. On timeout, control passes to the next command by default.
The timeout delay defaults to 10 seconds, but can be changed with
the TIMEOUT command, as can the action taken on timeout. The
message must be delimited with single quotes. You may include
control codes by specifying them outside the quotes, either of
two ways. You can use a pound sign "#", followed by the ASCII
code of the character to send. You can also use a caret "^",
followed by the letter for the control code you wish to generate.
For instance, to wait for the message "Enter your last name:",
you would use:
INPUT 'Enter your last name:'
OUTPUT message
Sends a message out the comm port. The message must be delimited
with single quotes. You may include control codes by specifying
them outside the quotes, either of two ways. You can use a pound
sign "#", followed by the ASCII code of the character to send.
You can also use a caret "^", followed by the letter for the
control code you wish to generate. For instance, to send the
message "Enter your last name: ", followed by a beep (ASCII 7)
and a carriage return (control+M), you would enter the following:
OUTPUT 'Enter your last name: '#7^M
12
PARITY parity wordlength
Sets the parity and word length parameters for communications.
The parity may be EVEN, ODD, or NONE. The word length must be 7
or 8. You must use a parity of NONE when using a word length of
8:
PARITY NONE 8
PHONETYPE tone/pulse
Determines the type of dialing to use, for the type of phone
service you have. Valid settings are TONE and PULSE.
PHONETYPE TONE
PORT commport
Sets the communications port. This can be either 1 (com1) or 2
(com2):
PORT 1
PRINT MESSAGE
Sends a message to the screen. This message must be delimited
with single quotes. You may include control codes by specifying
them outside the quotes, in either of two ways. You can use a
pound sign "#", followed by the ASCII code of the character to
send. You can also use a caret "^", followed by the letter for
the control code you wish to generate. The example sends a beep
(control G), followed by the message "EZ Com. is ready",
followed by a carriage return (ASCII 13):
PRINT ^G'EZ Com. is ready'#13
RECEIVE protocol filename
Receives a file or files using one of the following protocols:
XMODEM, MODEM7, YSINGLE, or YMODEM.
YSINGLE is the single file variant of YMODEM (also called XMODEM-
1K). The more advanced CRC mode will be used if possible, but the
routine will fall back to the checksum mode, if the sender is
incapable of handling CRC. You do not have to specify a file name
for MODEM7 or YMODEM, which are batch file transfer protocols that
use the filename(s) specified by the sender. If the filename is
not given an extension, the default extension LZH will be used.
You may over-ride this by putting a period at the end of the file
name:
RECEIVE XMODEM ABM.LZH
RECEIVE YMODEM
13
RUN filename
Exits any existing script file and executes the script file
specified by filename. If no filename is specified, the current
script file will be restarted from the top:
RUN EFT
RUN
SEND protocol filename
Sends a file or files using one of the following protocols:
XMODEM, MODEM7, YSINGLE, or YMODEM.
YSINGLE is the single file variant of YMODEM (also called XMODEM-
1K). The more advanced CRC mode will be used if possible, but the
routine will fall back to the checksum mode, if the receiver is
incapable of handling CRC. You may specify wildcards in the
filename if using MODEM7 or YMODEM, which are batch file transfer
protocols that can send multiple files at a time. If the filename
is not given an extension, the default extension LZH will be used.
You may over-ride this by putting a period at the end of the file
name:
SEND XMODEM ABM.LZH
SEND MODEM7 *.LZH
SHELL filename
Shells to the DOS command line, optionally executing a filename
that you specify. You may return from the DOS command line by
typing EXIT. If a filename was specified, control will return to
your program when the shelled to program ends. You cannot SHELL
while connected to a remote computer.
SHELL
SHELL TYPE 950701.LOG
TIMEOUT delay scriptfile
Sets the timeout delay for the INPUT command. If the delay time
is exceeded without INPUT finding a match for the given message,
control will drop to the script file specified, or to the next
command, if there is no script file parameter. The delay is given
in eighteenths of seconds. The default delay is 180 (10 seconds):
TIMEOUT 18
TIMEOUT 90 NOTFOUND
14
WAIT waitparm
Waits for a given condition to be met. This condition is
specified by waitparm and may be either ANY, which waits for any
response from the comm port, or a number, which is a time delay
in eighteenths of seconds, or the time of day in military time,
i.e. 24:00 1s 12:00 midnight:
WAIT ANY
WAIT 18
WAIT 24:00
2-4 SCRIPT FILES
To run a script file, at the EZ Com. is ready prompt, press
Alt+F5, a window will display a prompt for you to enter the scrpt
file name. Once you enter the file name that script will be
executed.
Script files can be used to automate and speed-up command
processing. You may create your script files with a text editor,
or from the command line.
The following script file, is an example of an INIT.SCP file. You
must use an extension of SCP for all your script files.
At the system promt type:
COPY CON INIT.SCP <ENTER>
port 2 <Enter>
baud 1200 <Enter>
parity none 8 <Enter>
emulate dumb <Enter>
phonetype tone <Enter>
FUNCTION F1 DIAL 3185634428 EFT.SCP <Enter>
FUNCTION F2 DIAL 3185634428 PRENOTE.SCP <Enter>
Press F6 <Enter>
The following, is an example EFT.SCP file:
At the system promt type:
COPY CON EFT.SCP <ENTER>
OUTPUT 'Press Pg Dn to receive file ABM.LZH'#7^M <Enter>
SEND XMODEM ABM.LZH <Enter>
EXIT <Enter>
Press F6 <Enter>
At the prompt, EZ Com. is ready..., if you press F1 the phone number
3185634428 will be dialed. If a connection is made, the commands in
the EFT.SCP script file will be executed.
15
There are four script files provided with EZ Com., they are
SEND.SCP, RECEIVE.SCP, SENDPASS.SCP, & RECVPASS.SCP.
You may use a text editor to modify these files.
The SEND.SCP file contains:
WAIT ANY
TIMEOUT 90 SENDPASS
INPUT 'PASSWORD'^M
OUTPUT 'PASSWORD'^M
SEND YMODEM *.LZH
HANGUP
EXIT
The RECEIVE.SCP file contains:
WAIT TIME 24:00
DIAL 3185634428
OUTPUT 'PASSWORD'^M
TIMEOUT 180 RECVPASS
INPUT 'PASSWORD'^M
RECEIVE YMODEM
HANGUP
EXIT
The SENDPASS.SCP file contains:
PRINT 'INCORRECT PASSWORD'^M
HANGUP
RUN SEND.SCP
EXIT
The RECVPASS.SCP file contains:
PRINT 'INCORRECT PASSWORD'^M
HANGUP
RUN RECEIVE.SCP
EXIT
16